/*
 * Copyright (c) 2003-2010, Live Media Pty. Ltd.
 * All rights reserved.
 *
 * Redistribution and use in source and binary forms, with or without modification, are permitted
 * provided that the following conditions are met:
 *
 *  1. Redistributions of source code must retain the above copyright notice, this list of
 *     conditions and the following disclaimer.
 *  2. Redistributions in binary form must reproduce the above copyright notice, this list of
 *     conditions and the following disclaimer in the documentation and/or other materials
 *     provided with the distribution.
 *  3. Neither the name of Live Media nor the names of its contributors may be used to endorse
 *     or promote products derived from this software without specific prior written permission.
 *
 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR
 * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY
 * AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER
 * OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
 * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
 * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON
 * ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
 * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF
 * ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 */

package com.colony;

import java.io.IOException;

import com.argot.TypeException;
import com.argot.TypeLibrary;

import com.argot.remote.MetaLocation;
import com.argot.remote.MetaObject;

import com.colony.remote.RemoteException;

public interface IColonyClient
{
	public IContainer getHostContainer();

    public TypeLibrary getTypeLibrary();
    
	public Object getFront( MetaLocation location )
	throws ColonyException, RemoteException, TypeException;

	public Object getFront( MetaObject location )
	throws ColonyException, RemoteException, TypeException;
	
    public IProxyFactory getFactory( Class clss )
    throws ColonyException, TypeException;
    
    public void setFactory( Class clss, IProxyFactory factory );

    public void bind( String hostName, ColonyEnvironment environment ) 
    throws ColonyException, RemoteException, TypeException, IOException;
    
    public boolean isBound();

	public String getHost();

	public void disconnect()
	throws ColonyException;
}
